home *** CD-ROM | disk | FTP | other *** search
/ Floppyshop 2 / Floppyshop - 2.zip / Floppyshop - 2.iso / art&graf.ix / art-5110 / pixkrome / pixkrome.doc next >
Text File  |  1987-04-21  |  14KB  |  270 lines
  1. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  2.                       Obnokshus Software Limited Presents
  3.  
  4.                           *****    PIXIKROME    *****
  5.  
  6.                         24-Bit Image Processing Utility
  7.  
  8.                             Programmed in STOS Basic
  9.                                    By Mugley
  10.  
  11.                       Released as freeware December 1994
  12. ______________________________________________________________________________
  13.  
  14. Pixikrome is a program for the digital manipulation of 320*200 pixel images in
  15. 24-bit colour. It loads and saves in the QRT raytracer .RAW format and is also
  16. compatible with Spectrum 512 images, Neochrome Master rasters and most ST
  17. 16-colour screen formats. Pixikrome also directly supports the use of the Vidi
  18. ST video digitiser ( old version with separate colour splitter ). The program
  19. runs on any ST/E with 1 meg or more of memory and should work on Mega STE's.
  20.  
  21. Pixikrome was written due to the extreme lack of decent public domain image
  22. processing software that can run on an ordinary ST. There's Atari Image 
  23. Manager which is fine if you like tiny pictures and zero compatibility, 
  24. there's a few mono programs and there's some grossly overpriced commercial
  25. stuff. But I haven't been able to find anything that can do something as
  26. simple as putting a definable sine wave through a Spectrum image.
  27.  
  28. The main limitation of this utility is the inability of the ST to display 24-
  29. bit images. .RAW files need to be converted with a program such as Raw2Spec or
  30. Photochrome to be viewed on an ST/E. Images can be previewed within Pixikrome
  31. by splitting them into their component red, green and blue parts or by using 
  32. the quarter-screen 512-colour preview option.
  33.  
  34. Because Pixikrome is an image processor rather than a paint program, it can't
  35. generate pictures on its own and needs to be used alongside another graphics
  36. utility. It is most useful for users of QRT, Vidichrome and Spectrum 512.
  37. The process of down-converting from 24-bit to 3 or 4-bit colour is a bit 
  38. tedious to recommend regularly using Pixikrome for 16-colour images. Programs
  39. like Crack Art, Picture Concept and Art Master are more useful for this.
  40.  
  41. Pixikrome is mostly mouse-driven, with 8 on-screen menus and a couple of 
  42. keyboard commands. The functions of these are described below :
  43.  
  44. KEYBOARD COMMANDS:
  45. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  46. < CONTROL > Q - quits the program when pressed on the main menu screen.
  47.  
  48. < CONTROL > H - toggles 50/60 HZ scanrate on main menu screen.
  49.  
  50. RAW       ( .RAW Image Menu )
  51. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  52. Load   -  Calls up the fileselector to load a .RAW format image. Pretty bloody
  53.           obvious really.
  54.  
  55. Save   -  If you haven't worked this out by now I'm not going to tell you.
  56.  
  57. Update -  Updates the 24-bit image in memory according to what's in the 
  58.           program's red, green and blue buffers. Update should only be used if
  59.           you're using a digitiser or loading RGB screens separately.
  60.  
  61. INTENSITY      ( Colour Intensity Menu )
  62. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  63. This menu contains arrows for increasing and decreasing the levels of colour
  64. throughout the entire image in memory. The levels of red, green or blue can be
  65. altered separately or all at once ( RGB ). This can be very very useful for
  66. tweaking QRT files (eg. brightening or reddening the image) without having to
  67. change the script file and spend hours re-rendering the picture. It can also
  68. help to fix colour imbalances in digitised pics.
  69.  
  70. RED     GREEN     BLUE        ( Colour Separation Menu )
  71. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  72. The Load, Grab, Update and View options affect the separate red, green and blue
  73. colour planes of the picture. For the benefit of anyone who's never used a
  74. computer paint program, all colours are made up of varying levels of red, green
  75. and blue. No, I don't know or care why so I'm not going to explain it any 
  76. further.
  77.  
  78. Load   - This takes you to the 16-colour file format menu, where you select a
  79.          picture format and then pick a file with the selector ( don't you just
  80.          love the godawful STOS file selector? ). This image is then loaded
  81.          into the colour buffer of your choice. To actually affect the 24-bit
  82.          image in memory you have to select Update from the RAW Menu as I
  83.          explained earlier. The Load function is only really of any practical
  84.          use for merging separate colour planes grabbed with Vidichrome or 
  85.          other colour digitising software.
  86.  
  87. Grab   - This is for digitising directly into Pixikrome with the Vidi-ST 
  88.          cartridge and colour splitter. It has not been tested with the new
  89.          Vidi hardware ( Vidi-ST 12 with built-in splitter ) so I can only
  90.          say that I know it works with the old version. When Grab is selected,
  91.          it will continuously grab frames until a key is pressed. The picture
  92.          will move quite jerkily while the video is playing but there are no
  93.          problems when the video is paused. The button on the splitter will 
  94.          need to be set manually unless you want to do that thing with the 
  95.          video camera and the three filters.
  96.  
  97. Update - This updates the selected colour plane from the data of the 24-bit
  98.          image in memory. The main use of this is for checking the results of
  99.          various effects and filters on your image. There will be less detail
  100.          than in the full image because the 24-bit colour is scaled down to 
  101.          12-bit in order to display the colour plane in 16-shade mono.
  102.  
  103. View   - Displays the results of the last update. Pressing the r, g and b keys
  104.          will show the relevant colour plane. Useful for checking if grabbed
  105.          frames all line up properly. Because the colour buffers are not 
  106.          automatically updated when an effect is performed, the image shown by
  107.          View may not be the same as that in the 24-bit image. When in doubt,
  108.          update the colour plane first.
  109.  
  110. Update 512 - This generates a 512-colour image ( 16 colours per scanline ) from
  111.              the 24-bit image in memory. The image generated is only quarter-
  112.              screen size ( 160*100 ) because the routine is a bit slow and 
  113.              would take about 20 minutes to generate a full-screen image. As it
  114.              is, the routine takes about a minute before anything appears and
  115.              about 3-5 minutes altogether, depending on the image. QRT pics are
  116.              generally quicker than Vidi grabs. Update 512 is mostly useful for
  117.              checking the results of changes to colour intensity levels. For
  118.              checking other effects, updating a single colour plane is much 
  119.              quicker.
  120.  
  121. View 512  -  This allows you to view the last update of the 512-colour image
  122.              without having to recalculate.
  123.  
  124. DISK           ( Disk Operations Menu )
  125. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  126. Format -  Presents a dialogue box. Right clicking formats an 80-track, 10-
  127.           sector disk in drive A.
  128.  
  129. Delete -  Brings up the file selector to delete a file.
  130.  
  131. CONVERT        ( Image Conversion Menu )
  132. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  133. .SPC    -  Loads a Spectrum compressed image to convert to 24-bit colour.
  134.  
  135. .SPU    -  As above but for uncompressed Spectrum pics.
  136.  
  137. 16-col -  Brings up the 16-colour file format menu to convert. Pixikrome can
  138.           handle the following 16-colour formats :
  139.  
  140.              .ART -  Art Director.
  141.              .BL1 -  Degas block. An uncompressed IFF format, also used by 
  142.                      Cyberpaint.
  143.              .CEL -  Ani-ST cel image. A variant on the Neochrome format, also
  144.                      used by Cyberpaint.
  145.              .CNV -  Canvas uncompressed.
  146.              .FR0 -  Fractal Zoom.
  147.              .IFF -  ILBM imagefiles, compressed or uncompressed. At present 
  148.                      this routine only handles 4-bitplane 320*200 images, so
  149.                      it's probably only useful for ST-originated IFF's.
  150.              .IMG -  This option is greyed out and may be used for converting
  151.                      GEM bit images in a later version.
  152.              .MBK -  STOS compacted image in memory bank format.
  153.              .NEO -  Neochrome.
  154.              .OSL -  My own compressed format, can often pack better than the
  155.                      Tiny and packbits (ie Degas, IFF) compression methods.
  156.              .PAC -  STOS compacted image in binary file format. Not to be
  157.                      confused with mono STAD images which also use the .PAC
  158.                      file extender.
  159.              .PC1 -  Degas compressed.
  160.              .PI1 -  Degas uncompressed.
  161.              .TN1 -  Tiny compressed image.
  162.  
  163. .RST   -  Loads a Neochrome Master raster file, then brings up the 16-colour
  164.           format menu. Select a 16-colour file to convert from 16-col per line
  165.           rasters to 24-bit colour.
  166.  
  167. 2-PIC MIX          ( Image Mixing Menu )
  168. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  169. Options in this menu bring up everyone's favourite file selector to select a 
  170. .RAW file from disk. This file is then loaded and mixed with the image in 
  171. memory. The names of the options indicate the mathematical method used in the
  172. mix.
  173.  
  174. Max  -  This makes the lighter parts of each image overlay the darker parts of
  175.         the other. You'll probably need to try it to understand what I'm on 
  176.         about. This can be useful for pasting bright images over the top of
  177.         darker images, otherwise it just makes pretty abstracts. Max mixing,
  178.         as well as min and mean mixing, will take about 22 seconds after 
  179.         loading has finished.
  180.  
  181. Min  -  This has the opposite effect of max mixing.
  182.  
  183. Mean -  This combines the two pics by averaging the colour values of 
  184.         corresponding pixels. The result looks much better than this 
  185.         description sounds. 
  186.  
  187. And  -  Combines the two pics according to a logical AND operation. In practice
  188.         this gives results similar to min mixing, but a bit quicker ( about 4
  189.         seconds after loading ).
  190.  
  191. Or   -  Uses a logical OR operation, giving a similar result to max mixing but
  192.         with the same speed increase as AND mixing.
  193.  
  194. Xor  -  Uses a logical XOR operation. Takes about 4 seconds and gives quite
  195.         unpredictable results which usually make nice abstracts.
  196.  
  197. F-X            ( Special Effects Menu )
  198. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  199. Unrez   -  Reduces the resolution of the image and gives a mosaic effect, as
  200.            seen in quite a few paint packages.
  201.  
  202. Inverse -  Inverts the colours of the image, swapping black for white etc, and
  203.            producing a photo negative effect.
  204.  
  205. Shatter -  Moves lines apart to 'shatter' the image. If you've used Cyberpaint 
  206.            2 you'll know what I mean.
  207.  
  208. Sinewv  -  Displays the last update of the red plane and a menu for adjusting
  209.            the stretch and waviness of a sine wave through the image. When 'OK'
  210.            is selected, the sine wave will be put through the 24-bit image in
  211.            memory. The red plane should always be updated before selecting the
  212.            sinewave option.
  213.  
  214. Tanwave -  Similar to sinewv, but with a tan routine instead of sine.
  215.  
  216. H-flip  -  Flips the image horizontally.
  217.  
  218. V-flip  -  Flips the image vertically and horizontally.
  219.  
  220. L-mirr  -  Left mirror, reflects the left half of the screen in the right.
  221.  
  222. R-mirr  -  Right mirror.
  223.  
  224. T-mirr  -  Top mirror.
  225.  
  226. B-mirr  -  Bottom mirror.
  227.  
  228. FILTS           ( Digital Filter Menu )
  229. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  230. These are 3*3 local area filters, which you don't really need to know. For 
  231. practical purposes, these have strong effects over the entire image but take a
  232. bloody long time. All the filters take about 7 minutes 34 seconds to 7 minutes
  233. 42 seconds, with the exception of the Linear filter which takes just over 4
  234. minutes.
  235.  
  236. Max    -  This causes the light areas of the image to expand. Try it and see.
  237.  
  238. Min    -  Expands the dark areas of the image.
  239.  
  240. Mean   -  This has a very strong blurring effect.
  241.  
  242. Median -  Generally has a similar effect to either the max or min filters, but
  243.           also eliminates grungy noisy bits ( so did Kurt Cobain's shotgun! )
  244.           and sometimes appears to reduce resolution.
  245.  
  246. Linear -  This is a bit unpredictable, depending on the image. QRT pics can
  247.           sometimes get a metallic or washed-out appearance, while Vidi grabs
  248.           usually get a grungy super-8 type look.
  249. _______________________________________________________________________________
  250.  
  251. Well that's about it for the instructions bit. If this has all sounded a bit
  252. pointless, it's probably because you don't need the program. Pixikrome is 
  253. aimed at QRT and Vidichrome users who want fine control over the appearance of
  254. their images.
  255.  
  256. Pixikrome may be freely distibuted as long as it is accompanied by this text
  257. file. The author takes no responsibility for any loss of data, software or
  258. hardware damage, invasions of Poland, suicide of crap rock stars, or loss of
  259. erectile functions caused by direct or indirect use, misuse, abuse or inability
  260. to use this program.
  261.  
  262.                  Coming soon from Obnokshus Software Limited :
  263.                              The Baywatch Utility!
  264.                  It doesn't actually do anything, but it looks 
  265.                               great in a swimsuit.
  266.  
  267. _______________________________________________________________________________
  268. The next line says '-END OF FILE-' ( if you're on the Desktop )
  269.  
  270.